Laravel API 开发推荐阅读清单
社区优秀文章
API 文档神器 Swagger 介绍及在 PHP 项目中使用 - API 文档撰写方案
单个 Laravel 项目同时配置不同域名 api.domain(用户端接口) 和 admin.domain(管理员端)
一套安全的 API 方案,第一步要做的事情就是部署 HTTPS
安全必读。
开发 API 必读文章
- Principles of good RESTful API Design(译:好 RESTful API 的设计原则 )简单易懂,条理清晰,推荐
- Best Practices for Designing a Pragmatic RESTful API(译:RESTful 最佳实践 译文2)有实际的案例 Enchant
- HTTP API Design Guide(译:HTTP API 设计指南)
- Some REST best practices
- 理解 RESTful 架构 - 阮一峰 简单了解什么是 RESTFul
- RESTful API 设计指南 - 阮一峰
- Restful API 的设计规范 实战经验的总结,具有较强的启发意义
- 撰写安全合格的REST API 利用好 HTTP 协议所具备的特征
- Web 服务编程,REST 与 SOAP REST 与传统的面向服务的接口设计的区别,启发性强
- 最佳实践:更好的设计你的 REST API 了解 REST 实现缓存的过程
- Thoughts on RESTful API Design
- REST API Tutorial 全方位介绍 REST
- HTTP 接口设计指北
- Web API Design 接口就是开发人员提供的"界面",用户体验在接口设计上同样重要,在线查看 2012 版、2013 版
- 架构风格与基于网络应用软件的架构设计 原汁原味的博士论文,由李锟翻译,有经验的同学可以挑战一下
- Microsoft REST API Guidelines 微软官方的 REST API 设计指南,值得参考
- 理解 HTTP 幂等性 讲得很清楚,推荐
- 浅析远程过程调用 RPC 告诉你什么是 RPC
- httpstatuses 一眼看完所有常用的 HTTP 状态码,还可以看详细含义
- json-api 对 API 应该如何利用好 JSON 的一些建议
- 介绍 JSON 无论如何都应该读一遍
- decision-graph.svg 一张大图展示整个 REST API 的验证过程,及各种状态码出现的时机
现成 API 例子
- Github API v3 被很多人参考和引用,比如对分页的处理方法、接口版本的设计等等
- Mailgun Documentation 邮件服务 REST API
- Enchant REST API
- Coinbase API 设计的挺好的,包括官网提供的接口客户端,都是具有参考意义的
- OpenNMS Wiki ReST API
- REST API 使用详解 Lean Cloud 中讲解 REST API 的使用,还集成 Swagger UI 在线调试工具,点击查看。
调试工具
- DHC (aka Dev HTTP Client) Chrome 插件,简单易用,可分类管理,界面友好
- Fiddler2 Windows 下抓包必备,捕捉每一次 REST 请求和响应的详细内容
- Charles Proxy Mac 下抓包必备
- Postman 功能齐全的 API 请求工具
Laravel API 课程
社区有一门实战课程 《Laravel 教程实战高级 - 构架 API 服务器》 ,主要专注于 App 和 SPA 后端 API 服务器实战开发。手把手带你构建一个设计合理的 RESTful API 服务器。本课程涉及的技术话题有:
- RESTFul 的概念及 Github Api 设计分解;
- DingoApi 的介绍及安装;
- PostMan 的介绍及使用;
- 用户认证 —— 手机注册、登录、退出;
- 第三方认证 —— 微信登录、JWT的使用;
- 用户信息 —— 获取个人信息、上传图片接口、修改个人信息;
- 话题接口 —— 发布、修改、删除、列表;
- 话题回复接口 —— 发布、修改、删除、列表;
- 权限控制 —— 权限列表,角色列表;
- 资源推荐接口、活跃用户接口;
- 接口本地化处理;
- API 接口错误代码机制;
- APNS 消息推送服务器端介绍及实现;
- API 测试 —— 单元测试、集成测试、黑盒测试;
- 快速完成 API 文档;
- Passport / OAuth 2.0 认证。